home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / tt / brshwrks.lzh / README.DOC < prev   
Text File  |  1992-08-26  |  15KB  |  334 lines
  1.                 BRUSHWORKS TT
  2.  
  3. What is this anyway?
  4.  
  5. Brushworks TT is a full featured painting package for the TT' 256 color
  6. graphics mode, it contains many features not found in even the most expensive
  7. commercial programs and outperforms all in speed and ease of use.
  8.  
  9. Brushworks TT is SHAREWARE, it represents almost a year of coding and many 
  10. late nights hunched over my assembler. I have many more features I'd like to
  11. add and only you can help me do it. If you use this demo of the program and
  12. would like a version with the save options added as well as a couple of other
  13. extras, please send in your registration fee. In return you'll get the latest
  14. version of the program (with save enabled), a couple of my other handy TT
  15. utilities (screen grabber etc.) and a warm fuzzy feeling deep inside.
  16. You'll be helping a starving Australian programmer carry on his favourite
  17. pastime, and I know you'll all want to see a version of this on the Falcon.
  18.  
  19. O.K. So what do I have to do?
  20.  
  21. Send me $40 AUD (Australian dollars) or the equivalent thereof to this
  22. address:
  23.         Tony Barker
  24.         Moving Pixels
  25.         2/39 Frazer St
  26.         Leichhardt NSW 2040
  27.         AUSTRALIA
  28.  
  29. and make sure you include your address so I can send you your registered
  30. version.
  31. If your as poor as I am or a student and can't really afford that much or
  32. you don't think it's worth that much in the first place then send what you 
  33. can afford or what you think it is worth. I'm also open to suggestions as to
  34. features you'd like to see.
  35.  
  36. Possible troubles
  37.  
  38. If your tool bar flickers and jumps around then you've discovered a strange
  39. bug that affects the program on some TT's. I'm using a very sophisticated
  40. method for handling the toolbar involving some complex interrupts, this seems
  41. to cause a problem on some machines. A fix is at hand and will be included in
  42. all registered versions. You might try turning off the cache to remove the
  43. problem as a temporary fix.
  44.  
  45. So what can this version do ?
  46.  
  47. The following description will work across the front tools menu describing 
  48. each icon in turn and anything special about it's function. There will be a 
  49. description for what happens when clicked with the left mouse button and also 
  50. the right mouse button.
  51.  
  52. First a few explanations-
  53.  
  54. The program uses the concept of a foreground color and a background color. 
  55. The palette can be activated by hitting 'P' on the keyboard and the currently 
  56. selected fore and background colors are shown in 2 differrent ways. Firstly 
  57. the current foreground color has a solid horizontal marker above it and a 
  58. large bar of it appears in the bottom right hand corner. The background color 
  59. is indicated by a stippled bar underneath the color and a large bar of it 
  60. appears to the left of the foreground color bar. The foreground color is set 
  61. by clicking on it with the left mouse button and the background by the right 
  62. mouse button. When drawing with a brush you can draw with the background 
  63. color by pressing the right mouse button. Transparency is a complex feature 
  64. and takes some time getting to know but can be very powerful .Some things to 
  65. remember when using transparency are that it will work better on some 
  66. pictures than others due to the make up of their palettes. The better the 
  67. range of each of the main hues in the palette the more effective the feature 
  68. works. The reasons for this is that although there are 4096 colors, only the 
  69. 256 in the current picture are available so the transparency code has to do a 
  70. 'best fit' to get it's in between colors, this also explains the speed (or 
  71. lack of it) of this function.
  72.  
  73.  
  74. POINT DRAW:
  75. left mouse button-
  76.     The top left most icon, and the startup default is the PointDraw icon 
  77.     this allows freehand drawing with any one of the 8 predefined brushes 
  78.     or the user definable brush.
  79.  
  80. right mouse button-
  81.     Brings up the brush preferences menu. See the description under User 
  82.     definable brush.
  83.  
  84. CONTINUOUS DRAW:
  85. left mouse button-
  86.     Switches to continuous draw mode, lines will not be made up of a 
  87.     series of dots but will be continuous. This can make drawing very 
  88.     slow with large user brushes.
  89. right mouse button-
  90.     Brings up the brush preferences menu. See the description under User 
  91.     definable brush.
  92.  
  93. BOX DRAW:
  94. left mouse button-
  95.     Switches to box draw mode. Draws a box in the currently defined style
  96.     set by right mouse button.
  97. right mouse button-
  98.     Brings up the line preferences menu. 
  99.     When in the line preferences menu clicking on any of 
  100.     the boxes under the words 'Line Style' will edit the line pattern 
  101.     used when drawing boxes ,lines and curves. Clicking on 
  102.     them with the Right mouse button clears the particular 'bit' and 
  103.     clicking with the Right will set it. Clicking 'ALL' will set all the 
  104.     bits in the line to on and clicking 'NONE will do the opposite. 
  105.     Clicking on any of the 5 predefined line styles underneath the main 
  106.     style editor will set the editor up with that pattern. Clicking any 
  107.     of those boxes with the right mouse button will set the editor up 
  108.     with the inverse of that line pattern.
  109.     Under the line style settings are 3 buttons allowing you to choose
  110.     the style of box drawn. "BRUSH" will draw the box filled with a 
  111.     repeating pattern of the currently defined user brush (if none
  112.     defined the box will be empty or clear). "SOLID" will draw the box
  113.     filled with the current foreground color and "EMPTY" will just draw
  114.     the outline using the line preferences as described above.
  115.  
  116. ELIPSE DRAW:
  117. left mouse button-
  118.     Switches to elipse drawing mode. Allows you to draw an elipse
  119.     using the currently selected line, fill and brush settings.
  120. right mouse button-
  121.     Brings up the line style editor, see BOX DRAW mode.
  122.        
  123. LINE DRAW:
  124. left mouse button-
  125.     Switches to line draw mode. Will draw a line using the currently 
  126.     selected brush and linestyle.
  127. right mouse button-
  128.     Brings up the line style editor, see BOX DRAW mode.
  129.     Note that the "BRUSH FILLED EMPTY" buttons will not appear as they
  130.     do not apply to this tool.
  131.  
  132. SPLINE DRAW:
  133. left mouse button-
  134.     Switches to spline draw. A basic 4 point spline will be drawn on the
  135.     screen with thew control points visible. Clicking on the control
  136.     points allows you to "mould" the spline to how and where you want
  137.     it. When you have the spline as you require hitting the "SPACE" bar
  138.     will set it on the screen permanently. The spline will be drawn using
  139.     all the current settings.
  140. right mouse button-
  141.     Brings up the line style editor, see BOX DRAW mode.
  142.     Note that the "BRUSH FILLED EMPTY" buttons will not appear as they
  143.     do not apply to this tool.
  144.  
  145. AIRBRUSH MODE:
  146. left mouse button-
  147.     Switches to airbrush mode. Simulates a real airbrush with a
  148.     "centre weighted random elipsoidal dither". As usual the spray is
  149.     drawn using all the current settings and brush.
  150. right mouse button-
  151.     Brings up the airbrush settings menu. From here you can change the
  152.     flow rate (how fast new pixels are drawn) and the spray size.
  153.  
  154. USER BRUSH:
  155. left mouse button-
  156.     Allows the user to grab any rectangular area of the screen to use as 
  157.     a brush. When the selection is made the current draw mode will be 
  158.     returned (ie: line, box, pointdraw, linedraw etc)
  159. right mouse button-
  160.     Brings up the brush preferences menu. This is one of the most complex 
  161.     of the preference screens and should be read carefully.
  162.  
  163.     The 5 buttons on the left of this menu are used to set the current 
  164.     drawing mode for the brush. Only COLOR and CYCLE are applicable to 
  165.     predefined brushes but all apply to the user brush. COLOR sets all 
  166.     subsequent drawing to the currently selected foreground color 
  167.     regardless of what colors the brush may have in it. CYCLE, sets all 
  168.     drawing to be in colors cycling between the current foreground color 
  169.     and the current background color (see the palette menu for more 
  170.     info). MATTE, means the background color in the brush shall be 
  171.     considered transparent. REPLACE means the background color will 
  172.     replace any behind it making the brush appear as a solid block.
  173.  
  174.     All of these 5 modes can be accessed by the Function keys 1 to 5.
  175.  
  176.     TRANSPARENT means the brush will be drawn